apr

类 进程

系统.对象
    └apr.进程


公开 类 进程 <基类型 = 系统.对象

本类提供了操作进程的方法。在Windows上调用“创建进程”方法创建进程;在其它平台上调用“创建进程”或“派生进程”方法创建进程。


数据成员摘要
公开 静态 常量 整数

不分离 = 0 

    不分离

公开 静态 常量 整数

分离 = 1 

    分离

公开 静态 常量 整数

强制终止 = 1 

    该信号不能被进程忽略也不能被捕捉,如果发送给一个进程,系统将终止那个进程。

公开 静态 常量 整数

软终止 = 15 

    软终止信号,系统默认终止信号,进程可能忽略该信号。

方法摘要
公开 apr.返回码

派生进程(apr.内存池 内存池对象) 

    在WIN32平台未实现任何功能,返回“ENOTIMPL”。 在其它平台上,派生进程后子进程是父进程的副本,父子进程拥有独立的进程空间,父子进程只共享正文段。 调用本方法在父进程和子进程各返回一次,在子进程里返回“INCHILD”,在父进程里返回“INPARENT”,其它值表示失败。

公开 apr.返回码

创建进程(文本 程序路径, 文本[] 命令行参数<可为空>, 文本[] 环境变量<可为空>, apr.进程属性 进程属性对象, apr.内存池 内存池对象) 

公开 apr.返回码

创建进程() 

公开 整数,整数

等待(整数 标志) 

    等待子进程终止。本方法设置返回码(子进程执行完毕为CHILD_DONE,子进程尚未执行完为CHILD_NOTDONE)并返回两个值,成功时返回子进程终止状态(子进程的返回值)、子进程终止原因(见枚举“终止原因”),失败时两个返回值均为-1。

公开 整数,整数

等待任意子进程(整数 标志, apr.内存池 内存池对象) 

    等待任意子进程终止。本方法设置返回码(子进程执行完毕返回CHILD_DONE,子进程尚未执行完返回CHILD_NOTDONE)并返回两个值,成功时返回子进程终止状态、子进程终止原因(见枚举“终止原因”),失败时两个返回值均为-1。

公开 静态 apr.返回码

分离(逻辑 是否分离) 

    设置是否分离。设置分离后进程变为后台进程,默认为前台进程。

公开 apr.返回码

杀死子进程(整数 信号 = 15) 

    终止指定的子进程。

公开 apr.返回码

置关联内存池(apr.内存池 内存池对象, 整数 终止条件) 

    在指定的内存池销毁时如何处理该进程。

公开 整数

取子进程ID() 

    成功返回子进程ID,失败返回-1并设置返回码。

公开 apr.文件操作

取输入描述符() 

    取子进程的标准输入描述符。成功返回文件操作对象,失败返回空对象。

公开 apr.文件操作

取输出描述符() 

    取子进程的标准输出描述符。成功返回文件操作对象,失败返回空对象。

公开 apr.文件操作

取错误描述符() 

    取子进程的标准错误描述符。成功返回文件操作对象,失败返回空对象。

公开 静态 逻辑

是否正常终止(整数 终止原因) 

    判断终止原因是否被正常终止。

公开 静态 逻辑

是否信号中断(整数 终止原因) 

    判断终止原因是否被信号中断。

公开 静态 逻辑

是否生成core(整数 终止原因) 

    判断终止原因是否为信号中断并生成core文件。

公开 整数

置进程ID(整数 ID) 

    设置进程ID。在WIN32平台未实现功能,返回“ENOTIMPL”。

公开 静态 apr.返回码

杀死进程(apr.进程 进程对象, 整数 退出码 = 0) 

    杀死进程。

公开 静态 整数

取当前进程ID() 

    成功返回进程ID,失败返回-1。

系统.对象 继承的方法
比较类型, 是否实现, 取类名, 发送事件, 等于, 比较, 到文本, 比较引用

数据成员详细信息

不分离

公开 静态 常量 整数 不分离

    不分离


分离

公开 静态 常量 整数 分离

    分离


强制终止

公开 静态 常量 整数 强制终止

    该信号不能被进程忽略也不能被捕捉,如果发送给一个进程,系统将终止那个进程。


软终止

公开 静态 常量 整数 软终止

    软终止信号,系统默认终止信号,进程可能忽略该信号。


派生进程

公开 apr.返回码 派生进程(apr.内存池 内存池对象)

    在WIN32平台未实现任何功能,返回“ENOTIMPL”。 在其它平台上,派生进程后子进程是父进程的副本,父子进程拥有独立的进程空间,父子进程只共享正文段。 调用本方法在父进程和子进程各返回一次,在子进程里返回“INCHILD”,在父进程里返回“INPARENT”,其它值表示失败。

参数:

    内存池对象


创建进程

公开 apr.返回码 创建进程(文本 程序路径, 文本[] 命令行参数<可为空>, 文本[] 环境变量<可为空>, apr.进程属性 进程属性对象, apr.内存池 内存池对象)

参数:

    程序路径 - 子进程将加载该程序。

    命令行参数 - 数组可以为空。

    环境变量 - 提供给子进程的环境变量。如果本参数为空,则使用系统环境变量。

    进程属性对象

    内存池对象


创建进程

公开 apr.返回码 创建进程()


等待

公开 整数,整数 等待(整数 标志)

    等待子进程终止。本方法设置返回码(子进程执行完毕为CHILD_DONE,子进程尚未执行完为CHILD_NOTDONE)并返回两个值,成功时返回子进程终止状态(子进程的返回值)、子进程终止原因(见枚举“终止原因”),失败时两个返回值均为-1。

参数:

    标志 - 见枚举“等待选项”。


等待任意子进程

公开 整数,整数 等待任意子进程(整数 标志, apr.内存池 内存池对象)

    等待任意子进程终止。本方法设置返回码(子进程执行完毕返回CHILD_DONE,子进程尚未执行完返回CHILD_NOTDONE)并返回两个值,成功时返回子进程终止状态、子进程终止原因(见枚举“终止原因”),失败时两个返回值均为-1。

参数:

    标志 - 见枚举“等待选项”。

    内存池对象


分离

公开 静态 apr.返回码 分离(逻辑 是否分离)

    设置是否分离。设置分离后进程变为后台进程,默认为前台进程。

参数:

    是否分离 - 为“真”表示分离,为“假”表示不分离。


杀死子进程

公开 apr.返回码 杀死子进程(整数 信号 = 15)

    终止指定的子进程。

参数:

    信号 - 见本类静态成员“强制终止”或“软终止”。


置关联内存池

公开 apr.返回码 置关联内存池(apr.内存池 内存池对象, 整数 终止条件)

    在指定的内存池销毁时如何处理该进程。

参数:

    内存池对象 - 与进程关联的内存池。

    终止条件 - 见枚举“终止条件”。


取子进程ID

公开 整数 取子进程ID()

    成功返回子进程ID,失败返回-1并设置返回码。


取输入描述符

公开 apr.文件操作 取输入描述符()

    取子进程的标准输入描述符。成功返回文件操作对象,失败返回空对象。


取输出描述符

公开 apr.文件操作 取输出描述符()

    取子进程的标准输出描述符。成功返回文件操作对象,失败返回空对象。


取错误描述符

公开 apr.文件操作 取错误描述符()

    取子进程的标准错误描述符。成功返回文件操作对象,失败返回空对象。


是否正常终止

公开 静态 逻辑 是否正常终止(整数 终止原因)

    判断终止原因是否被正常终止。

参数:

    终止原因 - 见枚举“终止原因”。


是否信号中断

公开 静态 逻辑 是否信号中断(整数 终止原因)

    判断终止原因是否被信号中断。

参数:

    终止原因 - 见枚举“终止原因”。


是否生成core

公开 静态 逻辑 是否生成core(整数 终止原因)

    判断终止原因是否为信号中断并生成core文件。

参数:

    终止原因 - 见枚举“终止原因”。


置进程ID

公开 整数 置进程ID(整数 ID)

    设置进程ID。在WIN32平台未实现功能,返回“ENOTIMPL”。

参数:

    ID


杀死进程

公开 静态 apr.返回码 杀死进程(apr.进程 进程对象, 整数 退出码 = 0)

    杀死进程。

参数:

    进程对象

    退出码 - 见本类静态成员“强制终止”或“软终止”。


取当前进程ID

公开 静态 整数 取当前进程ID()

    成功返回进程ID,失败返回-1。



http://dotef.eyuyan.com